Creates a new equipment order or booking using data entered by a gate clerk if the specified equipment order does not exist.
N4 implements this business task only if the specified line operator allows creating ad hoc bookings. For more information on booking rules, see Booking Rules tab.
See also, CreateOrderItemIfUnknown (on page 1).
Pre-advise Vessel stage |
Pre-advise Rail stage |
Receive Export (RE) Dray In (RI) Receive Empty (RM) |
Receive Export (RE) Dray In (RI) Receive Empty (RM) |
Reads the hazard information from the pre-advised unit and associates the hazards with the gate transaction. If included at a gate stage, it saves the hazard information with the gate transaction; however, at the appointment stage, it does not save the hazard information because the gate transaction itself is not saved at the appointment stage.
Include the ReadAdvisedHazards business task only for automated or appointment gates. For manual gates, the gate forms automatically copy the hazard information.
Appointment stage |
Ingate stage |
Receive Export (RE) Through Container (TC) |
Receive Export (RE) Dray In (RI) Through Container (TC) |
Functional Area |
Appointment and Gate |
Execution Level |
Transaction |
Transaction Type(s) |
Appointment: Receive Export (RE) Gate: Receive Export (RE), Dray In (RI), Receive Empty (RM) |
Client Type(s) |
UI and Gate API |
Related Business Task(s) |
None |
Field(s) |
None |
Description
The business task reads the out-of-gage (OOG) details from a pre-advised unit or booking and applies these details to the appointment or gate transaction. The OOG value from unit is applied to the gate transaction only if the transaction has an appointment number or if the gate is auto gate (API).
If you include the CreateContainerPreadvisedVisit (on page 1) business task at an appointment stage, to apply the OOG details from a booking to the pre-advised unit, you must include the ReadAdvisedOOG business task.
Parameters
None
Dependencies
You must include the ReadAdvisedOOG business task at the first stage of a transaction for the RejectOOGIfNonOOGAdvised (on page 1) and RejectNonOOGIfOOGAdvised (on page 1) tasks to work properly.
Timing
For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).
For appointments, N4 processes business tasks on two occasions:
If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).
If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.
Custom Code
Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.
Reads the Gross Weight of the container from the appointment. It uses the Gross Weight from the appointment to automatically fill in the Advised Gross Weight field when creating a pre-advised unit.
If the Gross Weight field is not set in the appointment, the business task extracts the Gross Weight from the order item for the order and equipment type specified in the gate appointment.
Appointment stage |
Gate Stage |
Receive Export (RE) Through Container (TC) |
Receive Export (RE) Dray In (RI) |
Rejects a transaction if the category of the pre-advised unit does not match that entered at the gate.
Appointment stage |
Gate stage |
Receive Export (RE) |
Receive Export (RE) |
Rejects a gate transaction if the inspected container is not out-of-gage (OOG) and the pre-advise or booking for the container specifies an OOG container.
You must included the ReadAdvisedOOG (on page 1) business task at the first gate stage of the transaction type to attach pre-advised OOG details to the transaction.
Gate stage |
Receive Empty (RM) Receive Export (RE) Dray In (RI) |
Rejects a gate transaction if the inspected container is out-of-gage (OOG) and the pre-advise or booking for the container specifies a non-OOG container.
You must included the ReadAdvisedOOG (on page 1) business task at the first gate stage of the transaction type to attach pre-advised OOG details to the transaction.
Gate stage |
Receive Empty (RM) Receive Export (RE) Dray In (RI) |
The business task rejects a gate transaction if an Active or Advised unit already exists for the specified container and the Freight Kind and Category of the active or advised unit is not Empty and Storage, respectively. This ensures that you do not receive export or dray-in containers as empty/storage containers.
Functional Area
Gate
Execution Level
Transaction
Transaction Type(s)
Gate: Receive Empty (RM)
Client Type(s)
UI and Gate API
Parameters
None
Dependencies
None
Related Business Task(s)
None
Custom Code
None
Field(s)
None
Functional Area |
Appointment and Gate |
Execution Level |
Transaction |
Transaction Type(s) |
Appointment: Receive Export (RE) Gate: Receive Export (RE), Dray In (RI), Receive Empty (RM) |
Client Type(s) |
UI and Gate API |
Related Business Task(s) |
None |
Field(s) |
None |
Description
The business task, if included at the appointment stage, does not let you create an appointment if the container was not pre-advised already. Similarly, if you include the business task at the ingate stage, N4 rejects a gate transaction if the specified container was not pre-advised prior to its arrival at the ingate.
For more information on pre-advising a container, see Pre-advise Export Container form (on page 1) or Pre-advise Storage Empty Container form (on page 1).
Parameters
None
Dependencies
None
Timing
For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).
For appointments, N4 processes business tasks on two occasions:
If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).
If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.
Custom Code
Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.